下達一個目標為特定相對位置之運動指令。呼叫此命令時，給定之相對距離將添加於離散運動中最後一個指令位置。指令位置之定義請參考：McSource。
語法
KsCommandStatus MoveAxisAdditive(
int Index,
double Distance,
double Velocity,
double Acceleration,
double Deceleration,
double Jerk,
McBufferMode BufferMode
);參數
Index [in]：軸索引。索引以零為起點；別名將影響此參數。
Distance [in]：運動的相對距離，[單位]。
Velocity [in]：最大速度值，（非必要到達）[單位/秒]
Acceleration [in]：加速度值，單位由 McProfileType 類型決定，（馬達的增加能源） [單位/秒2] 或 [秒]。
Deceleration [in]：減速度值，單位由 McProfileType 類型決定，（馬達的減少能源） [單位/秒2] 或 [秒]。
Jerk [in]：加加速度值，單位由 McProfileType 類型決定，為 [單位/秒3] 或 [秒]。
BufferMode [in]：定義如何融合兩功能的速度，請見 McBufferMode 類型。
回傳值
返回 KsCommandStatus 結構。
備註
- 此命令完成後，軸移動的總距離為上一個移動命令給定的距離加上 MoveAxisAdditive 添加的距離。
- 若上一個命令是移動命令並被中斷，則運行 MoveAxisAdditive 時，軸將走的距離是上一個命令的剩餘距離加上 MoveAxisAdditive 增加的距離。
- 若前一個命令是速度命令，其將被中止並運行 MoveAxisAdditive。
- 更多關於融合模式的運作方式之資訊請見： 概念解說 > 融合運動。
範例
N/A使用需求
| RT | Win32 | |
|---|---|---|
| 最低支援版本 | 4.0 | 4.0 |
| 標頭檔 | ksmotion.h | ksmotion.h |
| 程式庫 | KsApi_Rtss.lib | KsApi.lib |
參見